WORK AND ENERGY
An interactive module for first-year engineering dynamics
=========================================================================

WHAT IT IS
  Eight short, interactive lessons on work and energy methods for a
  particle: the work of a force; weight, springs and friction; the
  principle of work and energy; power and efficiency; conservative
  forces and potential energy; conservation of energy; and energy on
  curved paths. Animated figures move a particle along a track and show
  its energy live, as energy bars or as a work ledger, and every lesson
  has worked examples and questions with instant feedback. It also has a
  Practice Lab, a Self-Check Quiz, a printable worksheet, an Energy
  Explorer, a formula sheet and a glossary.

  The notation follows Hibbeler's Engineering Mechanics: Dynamics
  (T, U_1-2, V_g, V_e). Units are SI, with g = 9.81 m/s^2.

  Everything runs in your web browser from this folder. No internet
  connection, installation or account is needed.

HOW TO OPEN
  1. Unzip (extract) the download first.
       Windows: right-click the .zip file > Extract All... > Extract.
       macOS:   double-click the .zip file. An unzipped folder appears
                next to it.
  2. Open the unzipped folder (it may hold another folder named
     "work-and-energy student") and double-click index.html. The module opens in
     your default web browser.
  3. Start with Lesson 1, or use "Continue where you left off" on the
     home page when you come back.

  Do not open the files from inside the zip preview (for example by
  double-clicking into the zip in File Explorer without extracting it).
  From there the pages cannot load their figures and styles, and your
  progress is not saved. Keep the folder structure as it is.

BROWSER SUPPORT
  Current versions of Google Chrome, Microsoft Edge, Mozilla Firefox and
  Apple Safari. JavaScript must be on (it is by default). A laptop or
  desktop screen works best; the pages also fit tablets and phones.

TROUBLESHOOTING
  Progress (lesson ticks, completed questions) is not saved
    Progress is stored by your browser, on this computer only. It is not
    kept in a private or incognito window, and it is lost if you clear
    browsing data or if your browser blocks cookies and site data for
    local files. Use a normal window, allow site data, and always open
    the module from the same folder in the same browser.

  The math shows raw code such as \( T_1 \), or there is no menu
    JavaScript is turned off. Turn it on in your browser settings, then
    reload the page.

  Pages have no styling or figures are missing
    A box at the top of the page says so too. Either you are viewing the
    files inside the zip (unzip first, see HOW TO OPEN, and open index.html
    from the unzipped folder), or your browser is not allowed to read the
    module's files. Browsers from the Mac App Store, such as DuckDuckGo,
    may only be allowed to open the one file you double-clicked, not the
    assets folder next to it. Right-click index.html, choose Open With, and
    pick Google Chrome, Microsoft Edge, Firefox or Safari.

  Animations stutter
    Close other tabs, or lower the Playback speed under the figure.

  Printing
    Use your browser's Print command (Ctrl+P, or Cmd+P on a Mac) and
    choose "Save as PDF" to keep a copy. The Formula Sheet, the
    Printable Worksheet and the quiz results are designed for printing.

FOLDER OVERVIEW
  index.html     Start here: the module home page
  README.txt     This file
  lessons/       Lessons 1-8
  practice/      Practice Lab, Self-Check Quiz, Printable Worksheet
  tools/         Energy Explorer (seven scenes with live energy)
  reference/     Formula Sheet and Glossary
  assets/        Styles, scripts and bundled libraries (never edit
                 assets/vendor)

CREDITS AND LICENSES
  This module bundles one open-source library, under the MIT License.
  Its full license text is in assets/vendor/katex.

  KaTeX 0.18.9 (math typesetting)
    Copyright (c) 2013-2020 Khan Academy and other contributors
    License: MIT, see assets/vendor/katex/LICENSE.txt
